Determines whether two FSRefs refer to the same file or directory.

OSErr PBCompareFSRefsSync (
    FSRefParam *paramBlock
);

paramBlock

A pointer to a parameter block

function result

A result code.

DISCUSSION

The relevant fields of the parameter block are:

• ioCompletion

  On input, a pointer to a completion routine.

• ioResult

  On output, the result code of the function. If the two FSRefs refer to the same file or directory, then noErr is returned. If they refer to objects on different volumes, then diffVolErr is returned. If they refer to different files or directories on the same volume, then errFSRefsDifferent is returned. This call may return other errors, including nsvErr, fnfErr, dirNFErr, and volOffLinErr.

• ref

  On input, a pointer to the first FSRef (ref1 in the high-level function, FSCompareFSRefs).

• parentRef

  On input, a pointer to the second FSRef (ref2 in the high-level function, FSCompareFSRefs).

You must use one of the three functions FSCompareFSRefs, PBCompareFSRefsSync, or PBCompareFSRefsAsync, to compare FSRefs. It is not possible to compare the FSRef structures directly since some bytes may be uninitialized, case-insensitive text, or contain hint information.

Some volume formats may be able to tell that two FSRefs would refer to two different files or directories, without having to actually find those objects. In this case, the volume format may return errFSRefsDifferent even if one or both objects no longer exist. Similarly, if the FSRefs are for objects on different volumes, the File Manager will return diffVolErr even if one or both volumes are no longer mounted.

AVAILABILITY

Supported in Carbon. Available in Mac OS 9, and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)